home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 151-175 / disk_153 / hpman / readme.hp < prev    next >
Text File  |  1992-05-06  |  10KB  |  240 lines
  1.                     HPMan V1.0: An HP Manipulator
  2.  
  3. A program to manipulate settings and fonts on HP LaserJet+ printers and
  4. compatibles.
  5.  
  6.                           By Steve Robb
  7.                            9 Epsom Ave
  8.                            Auckland 3
  9.                            New Zealand
  10.                         Ph N.Z. (9)608-871
  11.  
  12. Description:
  13. This program occupies approximately 33700 bytes on disk, and uses 36500
  14. bytes of memory.  It is intended occupy the title bar of the workbench. 
  15. It can be run from CLI or Workbench.
  16.  
  17. Background:
  18. After more than a year of fiddling with basic programs and batch files
  19. written with Scribble! and trying to remember the commands necessary
  20. with JetSet, I was rather frustrated.  I especially wanted a program that
  21. looked like an Amiga program i.e. pull-down menus, requesters etc.  I
  22. haven't found any programs like that yet, hence this attempt.
  23.  
  24. It was my initial intention to write a program that would simply
  25. download fonts.  However, once that module was written, the basis of a
  26. more generally useful program was there to be used with very little
  27. extra memory overhead.  A look through the PCLPak manual (that came
  28. with a set of soft fonts) was some help.  (If you wonder why the menus
  29. are arranged the way they are, their basic organisation was derived from
  30. this manual - one day I will tidy up the menus into a more orderly
  31. arrangement - any ideas?)
  32.  
  33. Acknowledgements to:
  34. ­   Kevin Lee Claque, Randy Finch, Martin Hash for `FileRequest()'
  35.    I have modified the version (Aug 87) to remove the changes to
  36. screen colours while the requester is displayed as this played
  37. havoc with my eyes in interlace display.
  38. ­   Lattice for v4.0
  39. ­   Fred Fish for all the public domain stuff from which I learned `C'
  40. ­   WordPerfect - this file was created with the best wordprocessor so
  41. far available for the Amiga, the source code was written with ProgramEdit
  42. from WordPerfect.
  43.  
  44.  
  45. Program Use:
  46. I think the program is mostly self explanatory.  But for those of you
  47. who don't have the benefit of the reference manual that came with the
  48. REAL LaserJet (as opposed to all the copies), some explanations are
  49. included below.  The program only uses the facilities available in the
  50. LaserJet.  It does save hopping up and down to press buttons on the
  51. front of the printer, and it does save having to remember all the escape
  52. sequences yourself.
  53.  
  54.  
  55.  
  56. PROJECT Menu:
  57.    About just in case someone removed the readme files
  58.  
  59.    Save Settings - saves the current settings for later retrieval
  60.  
  61.    Load Settings - loads and sets the last saved settings
  62.  
  63.  
  64. FONTS Menu:
  65.    Download font - each font sent to the printer is given an ID
  66.       number.  The ID number can be anything between 0 and 32767. 
  67.       The LaserJet's limits are a maximum of 32 fonts resident in the
  68.       printer at one time, and (for the LaserJet+ at least), a
  69.       maximum of 10 fonts used per page.  This program limits the
  70.       range of font ID's to between 1 and 20.  The font ID # 0 is
  71.       reserved for macro's (see later).
  72.      Note that the font ID # is automatically incremented just
  73.       before the Download requester is displayed.  All this means is
  74.       that if you want to overwrite a font, say font #6, then you
  75.       should set the font ID to #5 before calling the download
  76.       sequence.  Simple eh!
  77.  
  78.    Font ID - to select any number between 0 & 20.  See note above.
  79.  
  80.    Delete font - will delete the numbered font range 1-20.
  81.  
  82.    Delete All fonts - will delete all the fonts, whether they be
  83.       temporary or permanent, as opposed to the Reset function
  84.       which will only delete temporary fonts
  85.  
  86.  
  87.    Select Font - a nearly useless function.  However, the font you
  88.       select would become the font used by the PRT: device when
  89.       that is set for proportional mode.  Note that this selection is
  90.       reset every time you call the Print Sample function below.  If
  91.       there is enough demand, I will put in some code to preserve
  92.       the selected font ID.
  93.  
  94.    Print Sample 
  95.     Last font - prints a range of USASCII and extended ASCII
  96.       characters to show off the font you last downloaded OR the
  97.       font using the current ID (selected by Font ID above).  You
  98.       must eject the page yourself for this - I opted this way
  99.       deliberately to allow a range of fonts on one page.
  100.     All fonts - prints a single line of characters for each font, just
  101.       so that you know what you have selected.
  102.  
  103.    Make Permanent - will make the font with the current ID
  104.       permanent.  Permanent fonts will survive resets (but not Delete
  105.       ALL Fonts or power-offs).
  106.  
  107.    Font Report - this will make a written report the attributes of a
  108.      soft font.  In particluar, the report will note the style (upright
  109.      vs italic), weight (bold vs normal), spacing (proportional vs
  110.      fixed), orientation (portrait vs landscape), point size, pitch,
  111.      typeface, and others.  Note that values of these attributes are
  112.      derived from the font descriptor at the beginning of the font
  113.      file.  Some fonts, notably JetSet fonts, do not completely
  114.      follow the standard font descriptor format and may cause
  115.      confusion.
  116.  
  117.  
  118. FILE MANAGEMENT Menu:
  119.  
  120. Copy file - will copy a file to the current output device.  Note that
  121.      this can cause problems in certain circumstances.  If you have
  122.      selected the PRT: device as the current output device, copy
  123.      files containing HP specific escape sequences will just print
  124.      garbage.  Escape sequences for the PRT: device will print
  125.      garbage if sent directly to the LaserJet via PAR: or SER:. 
  126.      Know what you are sending!!
  127.  
  128. Destination - default is the PAR: device (my LaserJet+ is connected
  129.      to the parallel port - it is much faster than the serial port!!!). 
  130.      If your printer is connected to the serial port then use this
  131.      menu to change it.
  132.           The PRT: device is for downloading simple ASCII code to the
  133.      printer, such as source code, ED files etc.
  134.        I will next be working on the code to allow the creation of
  135.      disk files.  This would allow the creation of macro's, or groups
  136.      of fonts that can be downloaded all at once rather than having
  137.      to download each font individually.  Currently, I have limited
  138.      use for this facility, so this has been a low priority.
  139.  
  140.  
  141. PRINTER SETTINGS Menu:  (These save having to reach over to the
  142.      printer to select functions)
  143.  
  144. Orientation - to select either portrait (default) [across the page] or
  145.      landscape [along the page] mode.
  146.  
  147. Paper Source - selects either the internal tray (default), manual
  148.      sheet feeder or envelope settings.
  149.  
  150. Lines per Page - printer defaults depend on paper tray fitted.  66
  151.      lines for an A4 page, 60 lines for letter size pages (foolscap -
  152.      who uses foolscap ?).
  153.  
  154. Lines Per Inch - actually the LaserJet is capable of a greater range
  155.      of line spacings than the limited ones shown, but this
  156.      arrangement gives the simplest execution or the user.  If you
  157.      want to use other line spacings (0.5mm [1/48 inch] increments
  158.      are allowed) wait for the next version of this program.
  159.  
  160. Left Margin - default is 0, maximum is the current right margin
  161.      setting
  162.  
  163. Right Margin - default is right-most printable limit of page,
  164.      minimum value allowed is the current left margin setting.
  165.  
  166. Number of Copies - range 1 (default) to 99.  The LaserJet is not
  167.      known for its speed at accepting graphics.  But it can print at
  168.      8 pages per minute once the data is downloaded over.  Note
  169.      that programs such as DeluxePaint and CityDesk send a reset
  170.      before printing.  This prevents you from printing multiple
  171.      copies (shame, shame!!).
  172.   
  173. Auto Line Wrap - default is for this to be off.  Beware, if this is
  174.      on, it can muck up your text displays.
  175.  
  176. Line Termination - sets the printers interpretation of <RETURN>,
  177.      <LINE FEED>, and <FORM FEED>.
  178.  
  179. Reset (Defaults) - resets all but the permanent fonts.
  180.  
  181.  
  182. OTHER Menu:
  183.  
  184. Form Feed - ejects a page if there is any data on it.
  185.  
  186. Position Cursor - to position the `cursor' in units of:
  187.       a)   centimetres (cm)
  188.       b)   inches for those countries that don't like to keep up with
  189.              the times
  190.       c)   dots - 300 per inch, 120 per cm
  191.       d)   decipoints - 720 per inch, 288 per cm
  192.       e)   row and column
  193.  
  194. Rules - will allow lines, grey scales etc to be printed.  Wait for
  195.      next version.
  196.  
  197. Download overlays - any previously designed overlays can be copied and
  198.      activated.  The overlay is cancelled by selecting the `CANCEL'
  199.      gadget of the requester.
  200.  
  201.  
  202. Notes:
  203. 1.The menus FONTS, PRINTER SETTINGS, and OTHER will not allow
  204. data to be sent to the PRT: device.  This is to prevent HP specific
  205. escape sequences from confusing the PRT: device.  Data is
  206. automatically rerouted through the PAR: device instead of PRT:. 
  207. Rerouting will not occur if the current output device is PAR:, SER:,
  208. or a disk file.
  209.  
  210. 2.The program cannot tell what you have selected for the various
  211. settings previously, or what other programs have modified the
  212. settings to.  It presumes that it is the only one with control over
  213. the printer settings.
  214.  
  215. 3.BUGS are in there.  The menu checkmarks are not
  216. reset to the defaults on RESET.  Currently the program doesn't
  217. check to see that the printer is actually on line.  If the program
  218. appears to `hang', check the printer is turned on, and is on line. 
  219. Other bugs there may be, but I think the worst person to find bugs
  220. is the person who wrote the code.  I can't crash the program, and
  221. apart from the problems mentioned above, I can't see any other
  222. bugs.  But if you do find some, PLEASE let me know.
  223.  
  224. 4.All commands used by this program conform to HP's Printer
  225. Command Language.  So HPMan should also be able to control
  226. compatible printers such as the HP DeskJet, Star LaserWriter etc. 
  227. However, as I only own an HP LaserJet+, I can make no guarantees
  228. as to the performance of this program on anything other than a
  229. LaserJet+.
  230.  
  231. 5.This program is copyright to Steve Robb.  Permission is given to
  232. distribute the program freely by any means as long as the readme
  233. files are also included, and as long as those who make use of the
  234. program send $US10.00 to me at the above address, or their own
  235. SHAREWARE software as a swap (especially if their shareware
  236. relates to the LaserJet).
  237.  
  238. Steve Robb
  239. 13 July, 1988
  240.